Micron Document
πŸŽ–οΈGitΠ―Ρ€Π°πŸŽ–οΈ

Node / meshcore / MeshCore / files / docs / stats_binary_frames.md

Displaying Rendered β€’ View raw β€’ Download

docs/stats_binary_frames.md 890a2e2cffa98dea3ca88db3c3aba72ef23ff3f7 (890a2e2c) Text, 11.81 KB

Stats Binary Frame Structures

Binary frame structures for companion radio stats commands. All multi-byte integers use little-endian byte order.

Command Codes

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ Command β”‚ Code β”‚ Description β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚ T383838CMD_GET_STATS β”‚ 56 β”‚ Get statistics (2-byte command: code + sub-type) β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Stats Sub-Types

The T383838CMD_GET_STATS command uses a 2-byte frame structure:
β€’ Byte 0: T383838CMD_GET_STATS (56)
β€’ Byte 1: Stats sub-type:
β€’ T383838STATS_TYPE_CORE (0) - Get core device statistics
β€’ T383838STATS_TYPE_RADIO (1) - Get radio statistics
β€’ T383838STATS_TYPE_PACKETS (2) - Get packet statistics

Response Codes

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ Response β”‚ Code β”‚ Description β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚ T383838RESP_CODE_STATS β”‚ 24 β”‚ Statistics response (2-byte response: code + sub-type) β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Stats Response Sub-Types

The T383838RESP_CODE_STATS response uses a 2-byte header structure:
β€’ Byte 0: T383838RESP_CODE_STATS (24)
β€’ Byte 1: Stats sub-type (matches command sub-type):
β€’ T383838STATS_TYPE_CORE (0) - Core device statistics response
β€’ T383838STATS_TYPE_RADIO (1) - Radio statistics response
β€’ T383838STATS_TYPE_PACKETS (2) - Packet statistics response


RESPCODESTATS + STATSTYPECORE (24, 0)

Total Frame Size: 11 bytes

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ Offset β”‚ Size β”‚ Type β”‚ Field Name β”‚ Description β”‚ Range/Notes β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚ 0 β”‚ 1 β”‚ uint8_t β”‚ response_code β”‚ Always T3838380x18 (24) β”‚ - β”‚
β”‚ 1 β”‚ 1 β”‚ uint8_t β”‚ stats_type β”‚ Always T3838380x00 (STATSTYPECORE) β”‚ - β”‚
β”‚ 2 β”‚ 2 β”‚ uint16_t β”‚ battery_mv β”‚ Battery voltage in millivolts β”‚ 0 - 65,535 β”‚
β”‚ 4 β”‚ 4 β”‚ uint32_t β”‚ uptime_secs β”‚ Device uptime in seconds β”‚ 0 - 4,294,967,295 β”‚
β”‚ 8 β”‚ 2 β”‚ uint16_t β”‚ errors β”‚ Error flags bitmask β”‚ - β”‚
β”‚ 10 β”‚ 1 β”‚ uint8_t β”‚ queue_len β”‚ Outbound packet queue length β”‚ 0 - 255 β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Example Structure (C/C++)

T282828
Tff7b72struct T56d364StatsCore Tb4b4b4{
Tffa657uint8_t Te6edf3response_codeTb4b4b4; T8b949e// 0x18
Tffa657uint8_t Te6edf3stats_typeTb4b4b4; T8b949e// 0x00 (STATS_TYPE_CORE)
Tffa657uint16_t Te6edf3battery_mvTb4b4b4;
Tffa657uint32_t Te6edf3uptime_secsTb4b4b4;
Tffa657uint16_t Te6edf3errorsTb4b4b4;
Tffa657uint8_t Te6edf3queue_lenTb4b4b4;
Tb4b4b4} Te6edf3__attribute__Tb4b4b4(Tb4b4b4(Te6edf3packedTb4b4b4)Tb4b4b4)Tb4b4b4;



RESPCODESTATS + STATSTYPERADIO (24, 1)

Total Frame Size: 14 bytes

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ Offset β”‚ Size β”‚ Type β”‚ Field Name β”‚ Description β”‚ Range/Notes β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚ 0 β”‚ 1 β”‚ uint8_t β”‚ response_code β”‚ Always T3838380x18 (24) β”‚ - β”‚
β”‚ 1 β”‚ 1 β”‚ uint8_t β”‚ stats_type β”‚ Always T3838380x01 (STATSTYPERADIO) β”‚ - β”‚
β”‚ 2 β”‚ 2 β”‚ int16_t β”‚ noise_floor β”‚ Radio noise floor in dBm β”‚ -140 to +10 β”‚
β”‚ 4 β”‚ 1 β”‚ int8_t β”‚ last_rssi β”‚ Last received signal strength… β”‚ -128 to +127 β”‚
β”‚ 5 β”‚ 1 β”‚ int8_t β”‚ last_snr β”‚ SNR scaled by 4 β”‚ Divide by 4.0 for dB β”‚
β”‚ 6 β”‚ 4 β”‚ uint32_t β”‚ txairsecs β”‚ Cumulative transmit airtime i… β”‚ 0 - 4,294,967,295 β”‚
β”‚ 10 β”‚ 4 β”‚ uint32_t β”‚ rxairsecs β”‚ Cumulative receive airtime in… β”‚ 0 - 4,294,967,295 β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Example Structure (C/C++)

T282828
Tff7b72struct T56d364StatsRadio Tb4b4b4{
Tffa657uint8_t Te6edf3response_codeTb4b4b4; T8b949e// 0x18
Tffa657uint8_t Te6edf3stats_typeTb4b4b4; T8b949e// 0x01 (STATS_TYPE_RADIO)
Tffa657int16_t Te6edf3noise_floorTb4b4b4;
Tffa657int8_t Te6edf3last_rssiTb4b4b4;
Tffa657int8_t Te6edf3last_snrTb4b4b4; T8b949e// Divide by 4.0 to get actual SNR in dB
Tffa657uint32_t Te6edf3tx_air_secsTb4b4b4;
Tffa657uint32_t Te6edf3rx_air_secsTb4b4b4;
Tb4b4b4} Te6edf3__attribute__Tb4b4b4(Tb4b4b4(Te6edf3packedTb4b4b4)Tb4b4b4)Tb4b4b4;



RESPCODESTATS + STATSTYPEPACKETS (24, 2)

Total Frame Size: 26 bytes (legacy) or 30 bytes (includes T383838recv_errors)

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ Offset β”‚ Size β”‚ Type β”‚ Field Name β”‚ Description β”‚ Range/Notes β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚ 0 β”‚ 1 β”‚ uint8_t β”‚ response_code β”‚ Always T3838380x18 (24) β”‚ - β”‚
β”‚ 1 β”‚ 1 β”‚ uint8_t β”‚ stats_type β”‚ Always T3838380x02 (STATSTYPEPACKETS) β”‚ - β”‚
β”‚ 2 β”‚ 4 β”‚ uint32_t β”‚ recv β”‚ Total packets received β”‚ 0 - 4,294,967,295 β”‚
β”‚ 6 β”‚ 4 β”‚ uint32_t β”‚ sent β”‚ Total packets sent β”‚ 0 - 4,294,967,295 β”‚
β”‚ 10 β”‚ 4 β”‚ uint32_t β”‚ flood_tx β”‚ Packets sent via flood routing β”‚ 0 - 4,294,967,295 β”‚
β”‚ 14 β”‚ 4 β”‚ uint32_t β”‚ direct_tx β”‚ Packets sent via direct routing β”‚ 0 - 4,294,967,295 β”‚
β”‚ 18 β”‚ 4 β”‚ uint32_t β”‚ flood_rx β”‚ Packets received via flood routi… β”‚ 0 - 4,294,967,295 β”‚
β”‚ 22 β”‚ 4 β”‚ uint32_t β”‚ direct_rx β”‚ Packets received via direct rout… β”‚ 0 - 4,294,967,295 β”‚
β”‚ 26 β”‚ 4 β”‚ uint32_t β”‚ recv_errors β”‚ Receive/CRC errors (RadioLib); p… β”‚ 0 - 4,294,967,295 β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Notes

β€’ Counters are cumulative from boot and may wrap.
β€’ T383838recv = flood_rx + direct_rx
β€’ T383838sent = flood_tx + direct_tx
β€’ Clients should accept frame length β‰₯ 26; if length β‰₯ 30, parse T383838recv_errors at offset 26.

Example Structure (C/C++)

T282828
Tff7b72struct T56d364StatsPackets Tb4b4b4{
Tffa657uint8_t Te6edf3response_codeTb4b4b4; T8b949e// 0x18
Tffa657uint8_t Te6edf3stats_typeTb4b4b4; T8b949e// 0x02 (STATS_TYPE_PACKETS)
Tffa657uint32_t Te6edf3recvTb4b4b4;
Tffa657uint32_t Te6edf3sentTb4b4b4;
Tffa657uint32_t Te6edf3flood_txTb4b4b4;
Tffa657uint32_t Te6edf3direct_txTb4b4b4;
Tffa657uint32_t Te6edf3flood_rxTb4b4b4;
Tffa657uint32_t Te6edf3direct_rxTb4b4b4;
Tffa657uint32_t Te6edf3recv_errorsTb4b4b4; T8b949e// present when frame size is 30
Tb4b4b4} Te6edf3__attribute__Tb4b4b4(Tb4b4b4(Te6edf3packedTb4b4b4)Tb4b4b4)Tb4b4b4;



Command Usage Example (Python)

T282828
T8b949e# Send CMD_GET_STATS command
Tff7b72def Td2a8ffsend_get_stats_coreTb4b4b4(Te6edf3serial_interfaceTb4b4b4)Tb4b4b4:
T8b949e"""Send command to get core stats"""
Te6edf3cmd Tff7b72= Tffa657bytesTb4b4b4(Tb4b4b4[T79c0ff56Tb4b4b4, T79c0ff0Tb4b4b4]Tb4b4b4) T8b949e# CMD_GET_STATS (56) + STATS_TYPE_CORE (0)
Te6edf3serial_interfaceTff7b72.Td2a8ffwriteTb4b4b4(Te6edf3cmdTb4b4b4)

Tff7b72def Td2a8ffsend_get_stats_radioTb4b4b4(Te6edf3serial_interfaceTb4b4b4)Tb4b4b4:
T8b949e"""Send command to get radio stats"""
Te6edf3cmd Tff7b72= Tffa657bytesTb4b4b4(Tb4b4b4[T79c0ff56Tb4b4b4, T79c0ff1Tb4b4b4]Tb4b4b4) T8b949e# CMD_GET_STATS (56) + STATS_TYPE_RADIO (1)
Te6edf3serial_interfaceTff7b72.Td2a8ffwriteTb4b4b4(Te6edf3cmdTb4b4b4)

Tff7b72def Td2a8ffsend_get_stats_packetsTb4b4b4(Te6edf3serial_interfaceTb4b4b4)Tb4b4b4:
T8b949e"""Send command to get packet stats"""
Te6edf3cmd Tff7b72= Tffa657bytesTb4b4b4(Tb4b4b4[T79c0ff56Tb4b4b4, T79c0ff2Tb4b4b4]Tb4b4b4) T8b949e# CMD_GET_STATS (56) + STATS_TYPE_PACKETS (2)
Te6edf3serial_interfaceTff7b72.Td2a8ffwriteTb4b4b4(Te6edf3cmdTb4b4b4)



Response Parsing Example (Python)

T282828
Tff7b72import T7ee787struct

Tff7b72def Td2a8ffparse_stats_coreTb4b4b4(Te6edf3frameTb4b4b4)Tb4b4b4:
T8b949e"""Parse RESP_CODE_STATS + STATS_TYPE_CORE frame (11 bytes)"""
Te6edf3response_codeTb4b4b4, Te6edf3stats_typeTb4b4b4, Te6edf3battery_mvTb4b4b4, Te6edf3uptime_secsTb4b4b4, Te6edf3errorsTb4b4b4, Te6edf3queue_len Tff7b72= \
Te6edf3structTff7b72.Td2a8ffunpackTb4b4b4(Ta5d6ff'Ta5d6ff<B B H I H BTa5d6ff'Tb4b4b4, Te6edf3frameTb4b4b4)
Tff7b72assert Te6edf3response_code Tff7b72== T79c0ff24 Tff7b72and Te6edf3stats_type Tff7b72== T79c0ff0Tb4b4b4, Ta5d6ff"Ta5d6ffInvalid response typeTa5d6ff"
Tff7b72return Tb4b4b4{
Ta5d6ff'Ta5d6ffbattery_mvTa5d6ff'Tb4b4b4: Te6edf3battery_mvTb4b4b4,
Ta5d6ff'Ta5d6ffuptime_secsTa5d6ff'Tb4b4b4: Te6edf3uptime_secsTb4b4b4,
Ta5d6ff'Ta5d6fferrorsTa5d6ff'Tb4b4b4: Te6edf3errorsTb4b4b4,
Ta5d6ff'Ta5d6ffqueue_lenTa5d6ff'Tb4b4b4: Te6edf3queue_len
Tb4b4b4}

Tff7b72def Td2a8ffparse_stats_radioTb4b4b4(Te6edf3frameTb4b4b4)Tb4b4b4:
T8b949e"""Parse RESP_CODE_STATS + STATS_TYPE_RADIO frame (14 bytes)"""
Te6edf3response_codeTb4b4b4, Te6edf3stats_typeTb4b4b4, Te6edf3noise_floorTb4b4b4, Te6edf3last_rssiTb4b4b4, Te6edf3last_snrTb4b4b4, Te6edf3tx_air_secsTb4b4b4, Te6edf3rx_air_secs Tff7b72= \
Te6edf3structTff7b72.Td2a8ffunpackTb4b4b4(Ta5d6ff'Ta5d6ff<B B h b b I ITa5d6ff'Tb4b4b4, Te6edf3frameTb4b4b4)
Tff7b72assert Te6edf3response_code Tff7b72== T79c0ff24 Tff7b72and Te6edf3stats_type Tff7b72== T79c0ff1Tb4b4b4, Ta5d6ff"Ta5d6ffInvalid response typeTa5d6ff"
Tff7b72return Tb4b4b4{
Ta5d6ff'Ta5d6ffnoise_floorTa5d6ff'Tb4b4b4: Te6edf3noise_floorTb4b4b4,
Ta5d6ff'Ta5d6fflast_rssiTa5d6ff'Tb4b4b4: Te6edf3last_rssiTb4b4b4,
Ta5d6ff'Ta5d6fflast_snrTa5d6ff'Tb4b4b4: Te6edf3last_snr Tff7b72/ T79c0ff4.0Tb4b4b4, T8b949e# Unscale SNR
Ta5d6ff'Ta5d6fftx_air_secsTa5d6ff'Tb4b4b4: Te6edf3tx_air_secsTb4b4b4,
Ta5d6ff'Ta5d6ffrx_air_secsTa5d6ff'Tb4b4b4: Te6edf3rx_air_secs
Tb4b4b4}

Tff7b72def Td2a8ffparse_stats_packetsTb4b4b4(Te6edf3frameTb4b4b4)Tb4b4b4:
T8b949e"""Parse RESP_CODE_STATS + STATS_TYPE_PACKETS frame (26 or 30 bytes)"""
Tff7b72assert Tffa657lenTb4b4b4(Te6edf3frameTb4b4b4) Tff7b72>Tff7b72= T79c0ff26Tb4b4b4, Ta5d6ff"Ta5d6ffSTATS_TYPE_PACKETS frame too shortTa5d6ff"
Te6edf3response_codeTb4b4b4, Te6edf3stats_typeTb4b4b4, Te6edf3recvTb4b4b4, Te6edf3sentTb4b4b4, Te6edf3flood_txTb4b4b4, Te6edf3direct_txTb4b4b4, Te6edf3flood_rxTb4b4b4, Te6edf3direct_rx Tff7b72= \
Te6edf3structTff7b72.Td2a8ffunpackTb4b4b4(Ta5d6ff'Ta5d6ff<B B I I I I I ITa5d6ff'Tb4b4b4, Te6edf3frameTb4b4b4[Tb4b4b4:T79c0ff26Tb4b4b4]Tb4b4b4)
Tff7b72assert Te6edf3response_code Tff7b72== T79c0ff24 Tff7b72and Te6edf3stats_type Tff7b72== T79c0ff2Tb4b4b4, Ta5d6ff"Ta5d6ffInvalid response typeTa5d6ff"
Te6edf3result Tff7b72= Tb4b4b4{
Ta5d6ff'Ta5d6ffrecvTa5d6ff'Tb4b4b4: Te6edf3recvTb4b4b4,
Ta5d6ff'Ta5d6ffsentTa5d6ff'Tb4b4b4: Te6edf3sentTb4b4b4,
Ta5d6ff'Ta5d6ffflood_txTa5d6ff'Tb4b4b4: Te6edf3flood_txTb4b4b4,
Ta5d6ff'Ta5d6ffdirect_txTa5d6ff'Tb4b4b4: Te6edf3direct_txTb4b4b4,
Ta5d6ff'Ta5d6ffflood_rxTa5d6ff'Tb4b4b4: Te6edf3flood_rxTb4b4b4,
Ta5d6ff'Ta5d6ffdirect_rxTa5d6ff'Tb4b4b4: Te6edf3direct_rx
Tb4b4b4}
Tff7b72if Tffa657lenTb4b4b4(Te6edf3frameTb4b4b4) Tff7b72>Tff7b72= T79c0ff30Tb4b4b4:
Tb4b4b4(Te6edf3recv_errorsTb4b4b4,Tb4b4b4) Tff7b72= Te6edf3structTff7b72.Td2a8ffunpackTb4b4b4(Ta5d6ff'Ta5d6ff<ITa5d6ff'Tb4b4b4, Te6edf3frameTb4b4b4[T79c0ff26Tb4b4b4:T79c0ff30Tb4b4b4]Tb4b4b4)
Te6edf3resultTb4b4b4[Ta5d6ff'Ta5d6ffrecv_errorsTa5d6ff'Tb4b4b4] Tff7b72= Te6edf3recv_errors
Tff7b72return Te6edf3result



Command Usage Example (JavaScript/TypeScript)

T282828
T8b949e// Send CMD_GET_STATS command
Tff7b72const Te6edf3CMD_GET_STATS Tff7b72= T79c0ff56Tb4b4b4;
Tff7b72const Te6edf3STATS_TYPE_CORE Tff7b72= T79c0ff0Tb4b4b4;
Tff7b72const Te6edf3STATS_TYPE_RADIO Tff7b72= T79c0ff1Tb4b4b4;
Tff7b72const Te6edf3STATS_TYPE_PACKETS Tff7b72= T79c0ff2Tb4b4b4;

Tff7b72function Te6edf3sendGetStatsCoreTb4b4b4(Te6edf3serialInterfaceTff7b72: Tffa657SerialPortTb4b4b4)Tff7b72: Tff7b72void Tb4b4b4{
Tff7b72const Te6edf3cmd Tff7b72= Tff7b72new Tffa657Uint8ArrayTb4b4b4(Tb4b4b4[Te6edf3CMD_GET_STATSTb4b4b4, Te6edf3STATS_TYPE_CORETb4b4b4]Tb4b4b4)Tb4b4b4;
Te6edf3serialInterfaceTb4b4b4.Te6edf3writeTb4b4b4(Te6edf3cmdTb4b4b4)Tb4b4b4;
Tb4b4b4}

Tff7b72function Te6edf3sendGetStatsRadioTb4b4b4(Te6edf3serialInterfaceTff7b72: Tffa657SerialPortTb4b4b4)Tff7b72: Tff7b72void Tb4b4b4{
Tff7b72const Te6edf3cmd Tff7b72= Tff7b72new Tffa657Uint8ArrayTb4b4b4(Tb4b4b4[Te6edf3CMD_GET_STATSTb4b4b4, Te6edf3STATS_TYPE_RADIOTb4b4b4]Tb4b4b4)Tb4b4b4;
Te6edf3serialInterfaceTb4b4b4.Te6edf3writeTb4b4b4(Te6edf3cmdTb4b4b4)Tb4b4b4;
Tb4b4b4}

Tff7b72function Te6edf3sendGetStatsPacketsTb4b4b4(Te6edf3serialInterfaceTff7b72: Tffa657SerialPortTb4b4b4)Tff7b72: Tff7b72void Tb4b4b4{
Tff7b72const Te6edf3cmd Tff7b72= Tff7b72new Tffa657Uint8ArrayTb4b4b4(Tb4b4b4[Te6edf3CMD_GET_STATSTb4b4b4, Te6edf3STATS_TYPE_PACKETSTb4b4b4]Tb4b4b4)Tb4b4b4;
Te6edf3serialInterfaceTb4b4b4.Te6edf3writeTb4b4b4(Te6edf3cmdTb4b4b4)Tb4b4b4;
Tb4b4b4}



Response Parsing Example (JavaScript/TypeScript)

T282828
Tff7b72interface Te6edf3StatsCore Tb4b4b4{
Te6edf3battery_mvTff7b72: Tffa657numberTb4b4b4;
Te6edf3uptime_secsTff7b72: Tffa657numberTb4b4b4;
Te6edf3errorsTff7b72: Tffa657numberTb4b4b4;
Te6edf3queue_lenTff7b72: Tffa657numberTb4b4b4;
Tb4b4b4}

Tff7b72interface Te6edf3StatsRadio Tb4b4b4{
Te6edf3noise_floorTff7b72: Tffa657numberTb4b4b4;
Te6edf3last_rssiTff7b72: Tffa657numberTb4b4b4;
Te6edf3last_snrTff7b72: Tffa657numberTb4b4b4;
Te6edf3tx_air_secsTff7b72: Tffa657numberTb4b4b4;
Te6edf3rx_air_secsTff7b72: Tffa657numberTb4b4b4;
Tb4b4b4}

Tff7b72interface Te6edf3StatsPackets Tb4b4b4{
Te6edf3recvTff7b72: Tffa657numberTb4b4b4;
Te6edf3sentTff7b72: Tffa657numberTb4b4b4;
Te6edf3flood_txTff7b72: Tffa657numberTb4b4b4;
Te6edf3direct_txTff7b72: Tffa657numberTb4b4b4;
Te6edf3flood_rxTff7b72: Tffa657numberTb4b4b4;
Te6edf3direct_rxTff7b72: Tffa657numberTb4b4b4;
Te6edf3recv_errors?Tff7b72: Tffa657numberTb4b4b4; T8b949e// present when frame is 30 bytes
Tb4b4b4}

Tff7b72function Te6edf3parseStatsCoreTb4b4b4(Te6edf3bufferTff7b72: Tffa657ArrayBufferTb4b4b4)Tff7b72: Te6edf3StatsCore Tb4b4b4{
Tff7b72const Te6edf3view Tff7b72= Tff7b72new Tffa657DataViewTb4b4b4(Te6edf3bufferTb4b4b4)Tb4b4b4;
Tff7b72const Te6edf3response_code Tff7b72= Te6edf3viewTb4b4b4.Te6edf3getUint8Tb4b4b4(T79c0ff0Tb4b4b4)Tb4b4b4;
Tff7b72const Te6edf3stats_type Tff7b72= Te6edf3viewTb4b4b4.Te6edf3getUint8Tb4b4b4(T79c0ff1Tb4b4b4)Tb4b4b4;
Tff7b72if Tb4b4b4(Te6edf3response_code Tff7b72!== T79c0ff24 Tff7b72|| Te6edf3stats_type Tff7b72!== T79c0ff0Tb4b4b4) Tb4b4b4{
Tff7b72throw Tff7b72new Tf85149ErrorTb4b4b4(Ta5d6ff'Invalid response type'Tb4b4b4)Tb4b4b4;
Tb4b4b4}
Tff7b72return Tb4b4b4{
Te6edf3battery_mvTff7b72: Tffa657view.getUint16Tb4b4b4(T79c0ff2Tb4b4b4, Tff7b72trueTb4b4b4)Tb4b4b4,
Te6edf3uptime_secsTff7b72: Tffa657view.getUint32Tb4b4b4(T79c0ff4Tb4b4b4, Tff7b72trueTb4b4b4)Tb4b4b4,
Te6edf3errorsTff7b72: Tffa657view.getUint16Tb4b4b4(T79c0ff8Tb4b4b4, Tff7b72trueTb4b4b4)Tb4b4b4,
Te6edf3queue_lenTff7b72: Tffa657view.getUint8Tb4b4b4(T79c0ff10Tb4b4b4)
Tb4b4b4}Tb4b4b4;
Tb4b4b4}

Tff7b72function Te6edf3parseStatsRadioTb4b4b4(Te6edf3bufferTff7b72: Tffa657ArrayBufferTb4b4b4)Tff7b72: Te6edf3StatsRadio Tb4b4b4{
Tff7b72const Te6edf3view Tff7b72= Tff7b72new Tffa657DataViewTb4b4b4(Te6edf3bufferTb4b4b4)Tb4b4b4;
Tff7b72const Te6edf3response_code Tff7b72= Te6edf3viewTb4b4b4.Te6edf3getUint8Tb4b4b4(T79c0ff0Tb4b4b4)Tb4b4b4;
Tff7b72const Te6edf3stats_type Tff7b72= Te6edf3viewTb4b4b4.Te6edf3getUint8Tb4b4b4(T79c0ff1Tb4b4b4)Tb4b4b4;
Tff7b72if Tb4b4b4(Te6edf3response_code Tff7b72!== T79c0ff24 Tff7b72|| Te6edf3stats_type Tff7b72!== T79c0ff1Tb4b4b4) Tb4b4b4{
Tff7b72throw Tff7b72new Tf85149ErrorTb4b4b4(Ta5d6ff'Invalid response type'Tb4b4b4)Tb4b4b4;
Tb4b4b4}
Tff7b72return Tb4b4b4{
Te6edf3noise_floorTff7b72: Tffa657view.getInt16Tb4b4b4(T79c0ff2Tb4b4b4, Tff7b72trueTb4b4b4)Tb4b4b4,
Te6edf3last_rssiTff7b72: Tffa657view.getInt8Tb4b4b4(T79c0ff4Tb4b4b4)Tb4b4b4,
Te6edf3last_snrTff7b72: Tffa657view.getInt8Tb4b4b4(T79c0ff5Tb4b4b4) Tff7b72/ T79c0ff4.0Tb4b4b4, T8b949e// Unscale SNR
Te6edf3tx_air_secsTff7b72: Tffa657view.getUint32Tb4b4b4(T79c0ff6Tb4b4b4, Tff7b72trueTb4b4b4)Tb4b4b4,
Te6edf3rx_air_secsTff7b72: Tffa657view.getUint32Tb4b4b4(T79c0ff10Tb4b4b4, Tff7b72trueTb4b4b4)
Tb4b4b4}Tb4b4b4;
Tb4b4b4}

Tff7b72function Te6edf3parseStatsPacketsTb4b4b4(Te6edf3bufferTff7b72: Tffa657ArrayBufferTb4b4b4)Tff7b72: Te6edf3StatsPackets Tb4b4b4{
Tff7b72const Te6edf3view Tff7b72= Tff7b72new Tffa657DataViewTb4b4b4(Te6edf3bufferTb4b4b4)Tb4b4b4;
Tff7b72if Tb4b4b4(Te6edf3bufferTb4b4b4.Te6edf3byteLength Tff7b72< T79c0ff26Tb4b4b4) Tb4b4b4{
Tff7b72throw Tff7b72new Tf85149ErrorTb4b4b4(Ta5d6ff'STATS_TYPE_PACKETS frame too short'Tb4b4b4)Tb4b4b4;
Tb4b4b4}
Tff7b72const Te6edf3response_code Tff7b72= Te6edf3viewTb4b4b4.Te6edf3getUint8Tb4b4b4(T79c0ff0Tb4b4b4)Tb4b4b4;
Tff7b72const Te6edf3stats_type Tff7b72= Te6edf3viewTb4b4b4.Te6edf3getUint8Tb4b4b4(T79c0ff1Tb4b4b4)Tb4b4b4;
Tff7b72if Tb4b4b4(Te6edf3response_code Tff7b72!== T79c0ff24 Tff7b72|| Te6edf3stats_type Tff7b72!== T79c0ff2Tb4b4b4) Tb4b4b4{
Tff7b72throw Tff7b72new Tf85149ErrorTb4b4b4(Ta5d6ff'Invalid response type'Tb4b4b4)Tb4b4b4;
Tb4b4b4}
Tff7b72const Te6edf3resultTff7b72: Tffa657StatsPackets Tff7b72= Tb4b4b4{
Te6edf3recvTff7b72: Tffa657view.getUint32Tb4b4b4(T79c0ff2Tb4b4b4, Tff7b72trueTb4b4b4)Tb4b4b4,
Te6edf3sentTff7b72: Tffa657view.getUint32Tb4b4b4(T79c0ff6Tb4b4b4, Tff7b72trueTb4b4b4)Tb4b4b4,
Te6edf3flood_txTff7b72: Tffa657view.getUint32Tb4b4b4(T79c0ff10Tb4b4b4, Tff7b72trueTb4b4b4)Tb4b4b4,
Te6edf3direct_txTff7b72: Tffa657view.getUint32Tb4b4b4(T79c0ff14Tb4b4b4, Tff7b72trueTb4b4b4)Tb4b4b4,
Te6edf3flood_rxTff7b72: Tffa657view.getUint32Tb4b4b4(T79c0ff18Tb4b4b4, Tff7b72trueTb4b4b4)Tb4b4b4,
Te6edf3direct_rxTff7b72: Tffa657view.getUint32Tb4b4b4(T79c0ff22Tb4b4b4, Tff7b72trueTb4b4b4)
Tb4b4b4}Tb4b4b4;
Tff7b72if Tb4b4b4(Te6edf3bufferTb4b4b4.Te6edf3byteLength Tff7b72>= T79c0ff30Tb4b4b4) Tb4b4b4{
Te6edf3resultTb4b4b4.Te6edf3recv_errors Tff7b72= Te6edf3viewTb4b4b4.Te6edf3getUint32Tb4b4b4(T79c0ff26Tb4b4b4, Tff7b72trueTb4b4b4)Tb4b4b4;
Tb4b4b4}
Tff7b72return Te6edf3resultTb4b4b4;
Tb4b4b4}



Field Size Considerations

β€’ Packet counters (uint32_t): May wrap after extended high-traffic operation.
β€’ Time fields (uint32_t): Max ~136 years.
β€’ SNR (int8_t, scaled by 4): Range -32 to +31.75 dB, 0.25 dB precision.

Served by rngit 1.5.0 - Generated in 0.11s